home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir24 / hamcomx.zip / HAMCOMX.EXE / HAM.DOC < prev    next >
Text File  |  1994-01-06  |  19KB  |  355 lines
  1.                                HAMCOM
  2.  
  3.                         Author: Dan Diehlman AE6G
  4.                                 5478 N. Bond
  5.                                 Fresno, CA 93710    209-439-5520
  6.  
  7. Note: The author of this program has expended considerable time and energy
  8.       in writing, testing and debugging of this program. Each copy is
  9.       customized for one call sign. If you would like to buy a registered copy,
  10.       contact me at the above address. You will then receive also any
  11.       corrections/updates.
  12.       It has, I believe, a couple of unique features, one being the QSO
  13.       card file which enables you to do away with any card file and gives
  14.       practically instantaneous response on Call Sign searches. The other
  15.       feature is the low RFI(noise) generated. This is very noticeable on
  16.       HF. During inactivity, the processor chip is put into a full halt
  17.       condition, thus eliminating birdies caused by instruction loops.
  18.       This was made possible by the fact that the program is completely
  19.       interrupt driven, therefore it can be put to sleep, then awakened by
  20.       a keystroke or communications activity. This was written to take
  21.       advantage of a PK232 -IBM/clone configuration, with 256K or more.
  22.  
  23.                   RUNNING THE PROGRAM
  24.  
  25. To run the program, copy all the files onto a
  26. diskette which already has Dos on it.
  27. Then type "Hamcom"
  28.      The first time you run the program, it will ask for information necessary
  29. for customization as follows:
  30.           prompt                       reply
  31.  What type TNC are you using?     Appropiate number.
  32.  What is your Call?               Your call
  33.  What is your Selcall?            Your Selcall (if you have not determined your
  34.                                                selcall, see 232 ref manual.)
  35.  Is this a PCJR? y/n             y or n
  36.  Which Comport 1 or 2 ?          1 or 2
  37.  Select type of Display Adapter  1-4
  38.  Are you using a Color Display?  y or n       n for monochrome monitors
  39.                                               y for any color monitors
  40.  Enter your CTEXT.Use > for CR   Your connect message. If you wish to imbed any
  41.                                           Carriage Returns, use the ">" symbol.
  42.  Enter your BTEXT.Use > for CR   Your beacon text.
  43.  Which Drive for default         Enter A,B,C or whatever drive you wish to be
  44.                                  the default drive for logging, receiving, and
  45.                                  sending files. It can be overridden in any
  46.                                  event when specifying a file i.e. B:xxx.xxx
  47.  Baud rate between TNC and computer.  Select any of the listed speeds. 1200 is
  48.                                  best. (You should use 1200 baud with the PK232)
  49.  Customized Packet Ending        This allows you to enter a special characters
  50.                                  which will be appended to your packets when
  51.                                  you release it with the "]" key. I set mine for
  52.                                  "==>" but set it for BK or whatever you like.
  53.  
  54. Special Parms:                   Opportunity to set additional/different
  55.                                  parameters. Separate them with a slash.
  56.                                  such as:    monitor on/txd 50
  57.  
  58. Do you have a 440-940 connected. Discussed later.
  59.  
  60. Is your primary output a Voice Synthesizer Y/N? Normally select "N". If "Y"
  61.                                  is selected then the screen is written thru
  62.                                  BIOS calls so that voice synthesizers can
  63.                                  intercept. Also assists the synthesizers in
  64.                                  pronouncing words instead of spelling the
  65.                                  words.
  66.  
  67. On subsequent runs of the program, you will not have to enter this information.
  68. It will be preserved in a file.  If, in the future, you desire to change these
  69. parameters, select "Alt F6" (F36) from the main screen.
  70.  
  71. The program will then proceed and stop on the main display, with the heading
  72. "The following data was stored in the TNC". Below it will be listed any
  73. connects you received, while your computer was off.
  74. This data ends with the message "1: Proceed with TNC reset" and "2:Proceed
  75. without TNC reset". The first time you run the program, use "1". This will
  76. set certain parms in the TNC. On subsequent runs, if the TNC has not been
  77. powered off, you can use "2".
  78.  
  79. After you depress a key the program will load it's other files , ending up
  80. back on the Main Screen.
  81.  
  82. The Main Screen displays any text from the TNC above the horizontal line, and
  83. any text that you type is displayed below the line. If you would like to
  84. change the line position, use the "Alt D" to raise or lower the divider.
  85. The lower left hand corner displays the current Mode of the TNC.
  86. The lower right of the screen displays the status of whether you are also
  87. logging to diskette, the data received from the TNC. At the far right on the
  88. bottom of the screen, a number (0-99) will appear on some TNC's. This number is
  89. an indication of how many connects you have had. It is reset to 0 by going to
  90. the Scroll Back Buffer.
  91. Also on the bottom line you can display Help in any mode by depress "Alt H". It
  92. can be turned off in the same manner.
  93.  
  94.  
  95. The Main Screen has the feature of being able to scroll back thru the received
  96. text. To use this feature: use the "Page Up" key to scroll back further. If
  97. you reach the top of the buffer, a message at the top of the screen will say
  98. "Top of Buffer:". You can at any point, scroll back down through the buffer
  99. using the "Page Down" key, or the "Home" key to get to the top of the buffer,
  100. or you can return to the Main Screen by depressing the "Esc". At any
  101. time, while in the Scroll Back Buffer, you can depress "Alt M" for a menu.
  102. While in the Scroll Back Buffer, you can "Mark" the beginning and "End" of
  103. a block of text, and then either "Send" the block or "Write" it to a file, or
  104. "Print" it. You may also load any Text File into the buffer. You can also
  105. edit the text in this buffer. You may also "Search" for particular words.
  106.  
  107.  
  108. Notepad: You can reach the Notepad screen from the Main Screen by depressing
  109. "Alt N". This screen is useful for any notes. I use it for recording tuner
  110. settings etc. The only keys in effect on this screen are the regular alpha/
  111. numeric keys and the Cursor positioning keys. Anything written onto this
  112. screen will be preserved in a file and read back in automatically whenever
  113. you rerun the program. You may exit this screen with the "ESC" key.
  114.  
  115. Menu: You can recall the Menu screen from the Main Screen by depressing "Alt M"
  116. On this screen are listed all the functions available from the Main Screen.
  117. F11 through F20 are invoked by using the regular function keys along with
  118. the Shift Key. i.e. F12 is called by using "Shift F2". Similarly F21 is called
  119. by using the Ctrl Key along with F1, additionally F31 is called by using the
  120. Alt key long with F1.
  121.  
  122. F1-F30: This is the User Macro function
  123.         Depressing F1 to F30 will execute Macros 1 to 30.
  124.         Initially all the macros will be empty. To create a macro depress
  125.         "Alt F". This will take you to a screen which displays the macros,
  126.         and gives you the opportunity to enter any macro. The screen is
  127.         self explanatory.
  128.     examples: "c w1aw>"  will initiate a connect to w1aw.
  129.               "m 4> mfrom yes all> mto yes all>" will set monitor to 4 etc.
  130.  
  131. F31: This will pull down a window and allow you to select different modes
  132.      on PK232  TNC's.
  133.  
  134. F32:Log to Disk. Initially the received data is being logged to "Logdat.1"
  135.     as indicated in the lower right hand part of the Main Screen.
  136.     This key will pull down a small window, allowing you to stop/restart a
  137.     new log, or to display the previous log, or to view any ASCII file.
  138.  
  139. F33: This will set the Date and Time in the TNC from the Dos clock.
  140.  
  141. F34: Allows you to Create/Send a Brag tape, the size is limited only by
  142.      Available disk space.
  143.  
  144. F35:File Transfer. This will send/receive any Ascii or Binary file. using
  145.     Hamcom's own protocol or Yapp protocol.
  146.     You will be prompted for the name of the file to send. A "File Xfer in
  147.     progress" message will be posted and at the completion a "File Xfer
  148.     Complete" message will be posted when all the data has been sent from
  149.     the computer to the TNC. Note: There may be remaining packets yet to be
  150.     sent and acknowledged in the TNC before the xfer is fully complete.
  151.     NOTE: To do Binary Transfers, you must have a Computer to TNC cable
  152.           that has pins 1-8 and 20. You cannot have just (TD,RD and ground).
  153.             (N O T E   T H I S   I S   V E R Y    I M P O R T A N T)
  154.  
  155. F37:CW Output. Causes your computer to output received text in CW using the
  156.     computer speaker. You can vary the speed up or down. This feature is for
  157.     the Diehard CW man who would rather copy CW even while working packet or
  158.     RTTY.
  159.  
  160. F39:Tone. This key toggles a tone on/off to help the visually impaired to
  161.     tune in data modes on hf. It sounds a 2100 hz note in all modes except
  162.     for Morse, in which mode, it sounds a 800 hz note.
  163.  
  164. F40:This will cause the received data to also go to the printer. Successive
  165.     depressions of this key toggles the feature On/Off.
  166.  
  167. Alt A:This will initiate a quick search of a call sign. In addition, it will
  168.     enter the callsign so that subsequent depressions of the "[" left bracket
  169.     will cause that callsign to be transmitted.
  170.  
  171. Alt B:Sound. This pulls down a menu which gives you control over the bell etc.
  172.     The soft bell can be selected or the regular bell, which is the default.
  173.     The soft bell is rather nice when you are in the room, and don't require
  174.     the harshness of the loud regular bell.
  175.  
  176. Alt X:End Program. Always use this to exit the Program. It will insure that all
  177.     necessary files are updated, and that the tnc is put in the proper state
  178.     to receive connect messages, and also set monitoring to 0.
  179.  
  180. Alt M: Menu.  Takes you to the Menu Screen from the Main Screen.
  181.  
  182. Alt N: Notepad. Takes you to the Notepad Screen, already discussed
  183.  
  184. Home: Clears the Main Screen.
  185.  
  186. Del: When using a PK232, this clears the transmit buffer in all modes.
  187.  
  188. Alt F: Setup Macros....previously discussed
  189.  
  190. Alt C: Sends CQ-automtically adjusts to whatever mode is in effect.
  191.  
  192. Alt G: This is a Special Function being used in development  work.
  193.        Not for general use.
  194.  
  195. Alt H: Toggles On/Off a summary of commands at the bottom of the Main Screen.
  196.  
  197. Alt K: This clears the Scroll Back Buffer.
  198.  
  199.         The program is set up so that the Esc key duplicates the Ctrl C
  200.         function, thus lessening the number of keystrokes necessary therefore
  201.         whenever you want to enter a Ctrl C, just hit the ESC key.
  202.         The Tab key is set up in packet to do Channel Switching more easily.
  203.         For instance, if you are in converse mode, in packet, and you wish to
  204.         switch to another channel, instead of typing Ctrl C,Chs X, K simply
  205.         type "Tab" and the number of the channel you are going to. It will
  206.         switch you to that channel and return you to converse mode.
  207.  
  208.         The program is set up so that the "Enter Key" does send the packet.
  209.         Or you may use the "right bracket" key to send the packet with your
  210.         customized ending. (substitute for BK or K or whatever).
  211.  
  212. Alt S:  Shows the current state of all packet streams.
  213.         Incidentally, when in a multiple connection situation, any change in
  214.         the received data stream, will automatically insert a solid line
  215.         accross the screen to alert you to the change.
  216. Alt Z:  Allows you to create messages for individual callers. Allows
  217.         personalized connect messages.
  218. Ctrl D: If in packet, sends a disconnect.
  219.  
  220. Baudot: self explanatory
  221. Ascii:  self explanatory
  222. Morse:  self explanatory
  223. Amtor:  normal operation except for turnaround, type only the "]". It is not
  224.         necessary to type the "?" .
  225.         The "Tab" key has been setup to force Turnaround. It is the equivalent
  226.         of going to control mode, typing ACHG, enter, k, enter. Again, we are
  227.         trying to save unnecessary keystrokes.
  228. FAX:    selects Fax mode, and turns Prcon On.
  229.  
  230. Alt L      This is a very usefull feature in that it is not necessary to
  231.            maintain a card file on your contacts. You can quickly go from
  232.            the Main Screen to search on Calls, and return, knowing the
  233.            calling party's name,qth, etc.
  234.            To implement this feature, type "Alt L".
  235.            You will be given several choices, however, until you have
  236.            created a database using the "Create" option, none of the other
  237.            functions will actually do anything. So intially choose.
  238.            "Scratch and Create DATABASE". It will then ask you to type the
  239.            word "CONFIRM" (must be in upper case), to proceed. The reason
  240.            for this added entry, is to prevent any accidental erasure. I
  241.            have a 128K file, and would hate to lose mine accidentally.
  242.            Enter a couple calls and the other requested information and then
  243.            do some searches to become familiar with this feature. A search
  244.            on a call is almost instantaneous with 1500 entries in the file.
  245.            Searches on QTH's, Activity(dates), takes longer as it must
  246.            sequentially go through the file to search for matches.
  247.            An "*" asterisk, limits the field searches, such as searching on
  248.            QTH thusly "TO*" will list all contacts with Tokyo and Toledo  and
  249.            Toocumcari if Toocumcari were spelled that way.
  250.            An Activity search such as "12/*/86" will list all qso's in Dec of
  251.            86. etc.
  252.            A Call Search such as "W3*" will list all qso's with W3's.
  253.  
  254. Alt P:     DOS SHELL. This feature allows you to temporarily leave the
  255.            program and go to DOS and run whatever you like. Whenever you
  256.            are finished, and have the Dos prompt, type "EXIT" and you will
  257.            return right back into the ham.com program, as though you had never
  258.            left. During your absence, the TNC will store any incoming messages
  259.            and give them to you on your return.
  260.  
  261. Alt T:     This is only active if you have stipulated in the configuration
  262.            the presence of a Kenwood 440 or 940 and the Kenwood inteface.
  263.            Selecting this function, will take you to a screen which
  264.            has a simulated transceiver dial, displaying the frequency, offset
  265.            modes, etc. The options are listed at the bottom of the screen.
  266.            To return to the Main Screen, depress Escape. If you are using a
  267.            440 you can build several databases using F14, and select any of
  268.            them to be loaded into the 440 memories.
  269.  
  270.            Naturally, it would be wise to backup your files occassionally.
  271.  
  272. If you have "snow" on the screen, redo the Hamparms and answer "Y" to the
  273.      question "Is your Primary Output a Voice Synthesizer".
  274.  
  275. If for some reason you need to include an ESC character ($1B or dec 27),
  276. the reverse apostrophe will send that character.
  277. You can store the other fellow's call by typing a "Alt A ", (This also
  278. gives a quick search of the log), and recall it by typing the Tilda "~".
  279. This is handy for modes other than packet where you must identify periodically.
  280.  
  281. If you are transferring a physical card file into the program's card file,
  282. it is best not to enter them in a sorted order, but rather in a harem/scarem
  283. order. Because of the search algorithm, search times will be reduced.
  284.  
  285. When using a PK232 in Morse, Baudot, Ascii modes, you can type ahead the
  286. text you want to send, even while receiving, and when you actually want
  287. transmission to begin, enter a "ctrl X".
  288.  
  289. Additionally, when using a PK232, you are far better off to remove the
  290. batteries. Sometimes the PK232 can get into a state wherefrom it is hard
  291. to exit as long as the batteries are inserted.
  292.  
  293. There are 3 parameters that can be used when calling the program.
  294. If you call the program thusly "Hamcom/1", it will load,restart then tnc,
  295. and continue without intervention.
  296. If you call the program thusly "Hamcom/2", it will load, and continue
  297. without manual intervention.
  298. You may also eliminate the beginning audible cw greeting by using the "/q"
  299. parameter.
  300. You may also add any parameter you would like set in the tnc, such as /'mon on'.
  301. You may bring the program up in a mode other than Packet by including that mode
  302. in the commandline thusly  "hamcom/Amtor".
  303. For illustration: I bring up my PK232 in Amtor mode, without the opening CW
  304. message, and without reinitializing the tnc thusly: "Hamcom/2/q/Amtor".
  305.                 I would appreciate any criticism . Thank You
  306.                 Hope you enjoy using the program.
  307.  
  308. The program assumes the following addresses for the Com Ports:
  309.             Com1      3F8       IRQ 4
  310.             Com2      2F8       IRQ 3
  311.             Com3      3E8       IRQ 4
  312.             Com4      2E8       IRQ 3
  313.  
  314.    ***** NOTE: PLEASE DO NOT USE WRITE PROTECT TAB ON YOUR WORKING DISK
  315.                HAMCOM NEEDS TO WRITE SEVERAL FILES TO THIS DISK
  316.  
  317.                -------------------------------------------------
  318.                              Dan Diehlman AE6G
  319.                              5478 N. Bond
  320.                              Fresno, CA 93710
  321.                              209-439-5520
  322.  
  323.                           COMMAND LINE PARAMETERS
  324. The following options, if included in the commandline which calls the
  325. program, will produce specific results.
  326. Q:         Causes a reduction in some of the sounds.
  327. D:         Special
  328. CWXMITOK:  Allows PTT to be operative in Morse mode
  329. DUALSPEED: Indicates to the program that a special 1200/9600 combo modem is
  330.            present in the TNC.
  331. NOANSI:    Forces the program to ignore ANSI sequences.
  332. KFS:       Special
  333. NOCLICK:   Eliminates  click which normally accompanies received text lines.
  334. CALLBOOK:  Indicates the host computer has a remote activated  
  335.            Callbook lookup.
  336. CW:        Allows computer to be used as a CW keyboard thru the printer
  337.            connector, without using a TNC.
  338. TRAP:      Sets up specific trap sequence to flag specific received data.
  339. WWV:       Will warn the operator at 17 mins past each hour.
  340. NO1200:    Will prevent remote requested downloads at 1200 baud.
  341. NOFILE:    Will prevent remote requested downloads.
  342. /1:        Will automatically initiate a "1" startup, resetting the TNC.
  343. /2:        Will bypass resetting the TNC.
  344. DIAGNOSTIC:Special parm not generally useable.
  345. NOMODECHG: Starts the TNC without changing it's mode.
  346. AMTOR:     Brings up the PK232 in Amtor mode.
  347. MORSE:     Brings up the PK232 in Morse mode.
  348. BAUDOT:    Brings up the PK232 in Baudot mode.
  349. ASCII:     Brings up the PK232 in Ascii mode.
  350. PACTOR:    Brings up the PK232 in Pactor mode.
  351. FAST:      Causes the default Morse speed to be 30 wpm
  352. IGNORE:    Causes the TNC to ignore a particular callsign.
  353. DISABLEMSG:Causes the TNC to not check for stored messages.
  354. NOFLOW:    Prevents pgm fm setting XFLOW ON and XOFF on exit.
  355.